home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr18
/
qhost211.zip
/
QHOST211.DOC
< prev
next >
Wrap
Text File
|
1993-05-08
|
28KB
|
673 lines
▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀ ▀▀▀▀▀ ▀▀▀▀▀▀
▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀
▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀ ▀▀ ▀▀▀▀ ▀▀
▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀
▀▀▀▀▀▀ ▀▀▀▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀ ▀▀▀▀▀ ▀▀
Version 2.11 by Christopher Saunders
Host Script File for Telix v3.20 and v3.21.
"Another fine CANADIAN product!"
Released May 8th 1993
LEGAL NOTICE
------------
QuickHost is provided "as is", without warranty of any kind,
either expressed or implied. The author only guarantees that
QuickHost will occupy disk space. In no event shall the author of
QuickHost be liable for any damages, including loss of profits,
lost data or other incidental or consequential damages arising
through the use, or inability to use this program.
QuickHost may not be hacked, disassembled, reverse engineered,
"Nortonized", altered, changed or in any way interfered with. You
are free to distribute QuickHost to your friends or other BBSs,
provided that the complete archive is distributed containing the
original files put there by the author.
Shareware disk vendors (Such as PC-SIG) may NOT include QuickHost
in their software library without written permission from the
author. No charge may be made to access this program, except any
copying and disk fees. BBS operators may put QuickHost in their
software libraries, provided that no charge is made to
specifically access QuickHost. The only charge that should be
made is to access your system.
WHAT IS QUICKHOST?
------------------
QuickHost is a small, fast host program written for Telix in SALT
(Script Application Language for Telix). The main purpose of
QuickHost is to allow people to call into your system without the
need for a big, complex BBS program. QuickHost is very easy to
install and use. You can have your very own system set up in only
a few minutes!
HOST PROGRAMS VS. BBS PROGRAMS
------------------------------
One thing that should be made perfectly clear is that QuickHost
is NOT a BBS program, it is a HOST PROGRAM. You will not find any
external door support, conferences, echo mail or multi-user chat
with QuickHost. If you want the aforementioned items, go and get
yourself a copy of PC-Board or RemoteAccess. However, if you want
a simple program to allow people to call you up without any fuss
or bother, then QuickHost is for you.
SCREEN DISPLAYS
---------------
If you have an EGA/VGA monitor, Telix allows you to change the
style of your display. The default display is 80x25 (that is, 80
characters across, 25 characters down). You can also have
displays of 80x43 and 80x50, which allow you to have more
information on your screen at once. The drawback of these
different displays are that the letters are very small, thus hard
to read, and that most scripts assume you are using 80x25.
QuickHost assumes that you are using 80x25, so it is a good idea
to make sure that you are in 80x25 mode, or QuickHost will look
very strange!
QUICKHOST FEATURES
------------------
Here is a list of some of the features that QuickHost has:
- Easy to set up and use!
- ASCII menus that you can edit
- 3 different access levels
- A chat feature
- Message to Sysop function
- 7 system bulletins
- Improved Sysop help menu
- Chat on/off toggle
- User inactivity timeout
- Colour added (LOCAL MODE ONLY!)
- Full user activity logging
- Improved message editor
INSTALLING QUICKHOST ON YOUR SYSTEM
-----------------------------------
The following files are included with QHOST210.ZIP:
LICENSE.DOC -----> The QuickHost License *READ*
LOGON1.MSG -----> Displayed to user before he/she logs on
LOGON2.MSG -----> Displayed to user after he/she logs on
GOODBYE.MSG -----> File displayed when user logs off
MENU.HLP -----> Help file for main menu functions
PROTOCOL.HLP -----> Help file for Protocol selections
MENU.1 -----> Menu for level 1 callers
MENU.2 -----> Menu for level 2 callers
MENU.3 -----> Menu for level 3 callers
PROTOCOL.MNU -----> Menu for available protocols
REMOTE.BAT -----> Remote batch file to run programs
SHELL.BAT -----> Batch file for remote DOS shell
EDIT.BAT -----> Batch file for editing user list
BULLETIN.1 -----> Bulletin #1
BULLETIN.2 -----> Bulletin #2
BULLETIN.3 -----> Bulletin #3
BULLETIN.4 -----> Bulletin #4
BULLETIN.5 -----> Bulletin #5
BULLETIN.6 -----> Bulletin #6
BULLETIN.7 -----> Bulletin #7
QHOST211.DOC -----> QuickHost documentation (this file)
QHOST211.SLC -----> QuickHost v2.11 script file
QHCONFIG.SLC -----> QuickHost configuration script
GATEWAY2.ARJ -----> The GATEWAY package
***<NOTE!>***
QuickHost is in NO WAY affiliated with GATEWAY! All rights,
copyrights and credit go to the author of GATEWAY. I only
included GATEWAY with the QuickHost archive for use with the
DOS shell. Read the GATEWAY manual on use of this program. I
accept NO responsibility for the behaviour of this program!
You use this program (GATEWAY) at your OWN risk!
Files created by QuickHost:
QHOST.CNF -----> The QuickHost configuration file.
USER.LST -----> The QuickHost user file
QHOST.LOG -----> The QuickHost log file
To install QuickHost:
1. Copy all of the QuickHost files into your MAIN Telix
directory (where TELIX.EXE is located). You do not need to
copy the .ZIP file or any documentation files into this
directory.
2. Copy the *.SLC files into your designated Telix script
directory.
3. Fire up Telix, and using the Alt-G command, run the script
file QHCONFIG.SLC.
4. You should now see the configuration screen. You will be
given three parameters to define:
Download directory - Where files for the caller will be made
available.
Upload directory - Where uploaded files will go.
Connection Type - Specify if the connection is to be made by
a modem or through connecting the terminals directly.
Select the option to edit and save your changes. Once the
information has been saved and QHCONFIG has finished, you
can now run QHOST20.SLC. Simply press ALT-G and then type
QHOST20. You should then see QuickHost start up.
QUICKHOST FUNCTIONS
-------------------
While QuickHost is waiting for a caller, there are some options
that are available to the Sysop:
1 - Exit to Telix <----- Returns to Telix
2 - Chat ON <----- Turns chat mode ON
3 - Chat OFF <----- Turns chat mode OFF
4 - DOS functions <----- Brings up DOS functions
5 - Local logon <----- Log on locally
6 - Configuration <----- Runs QHCONFIG.SLC
At the bottom of the screen, there is a status bar which tells
you that there is no caller online <OFFLINE>, and whether chat is
turned on or off.
When QuickHost answers a call, it will display the file
LOGON1.MSG, then it will ask the caller for his/her name or
alias. After the caller enters this, QuickHost will search the
file USER.LST for a match. If one is found, then it will ask for
the caller's password. If one is not found, it will ask the
caller whether he or she would like to register as a user or not.
If he/she doesn't want to, QuickHost promptly hangs up and waits
for the next call. If he/she answers yes, QuickHost will ask him
for a password, and makes sure that he/she remembers this by
asking him/her for it again. After this procedure is finished,
the user will be let into the host. His/her name and password
will be recorded in USER.LST, in the following format:
name;password;access level comment
NAME: The user's name/handle. It must be at least
four characters long.
PASSWORD: The user's password
ACCESS LEVEL: This is a one-digit field which denotes the
users level of access. There are three access
levels:
1 - This is the level given to first-time
callers by QuickHost. He/she has access
to all general functions, but the user
cannot upload, download or type any
files.
2 - The user has access to the general
functions except the DOS Shell, Remote
Program, Host Shutdown or Log Read.
2 - The user has level 2 access, plus access
to system functions listed later.
COMMENT: You can include any information about the
user you like. Here is where QuickHost notes
the date of the user's first log on.
Note: upper and lowercase do not matter with these parameters.
After the logon procedure is finished, the file LOGON.2 is
displayed, and the user is shown the file MENU.1 if he is a level
1 caller, MENU.2 if he is an access level 2 caller, and MENU.3 if
he is an access level 3 caller. Main menu commands are as
follows:
Commands for levels 1 and 2
[F]iles: Gives a list of all files available for
download, with file sizes, dates, and transfer
times. After each screen is filled, the display
will pause until a key is pressed.
[T]ype a File: Will type any ASCII text file in the download
directory. The file being displayed will pause
when the screen is filled, and pressing any key
will resume viewing.
Allows the user to leave a message to the Sysop.
There is no word wrap, so you must press ENTER
at the end of each line. To save your message,
press ENTER on a blank line. If you want to
insert a blank line, press SPACE once and then
ENTER. You have a maximum of 100 lines. The
message is stored in the user log.
[U]pload: Sets QuickHost up to receive a file from the
caller.
[D]ownload: Sends a file from QuickHost to the caller.
[C]hat: This will page the System Operator for 20
seconds. If the Sysop does not answer, the
caller will be able to leave him/her a short 5
line message which will be recorded in
QHOST.LOG.
[I]nitial Msg: This will re-display LOGON2.MSG
[1] Bulletin #1 This will show Bulletin #1
[2] Bulletin #2 This will show Bulletin #2
[3] Bulletin #3 This will show Bulletin #3
[4] Bulletin #4 This will show Bulletin #4
[5] Bulletin #5 This will show Bulletin #5
[6] Bulletin #6 This will show Bulletin #6
[7] Bulletin #7 This will show Bulletin #7
[V]ersion Info: This will display the current version number,
along with information on how to contact the
author of QuickHost (me!)
[G]oodbye: This will log the caller off, and set QuickHost
up for another caller.
[H]elp: This will display HELP.MSG
This will make QuickHost stop displaying the
[E]xpert Mode: main and protocol menus to the user.
NOTE: Access level 1 callers (new users) cannot upload, download
or type files, but they can view the files that are available.
COMMANDS AVAILABLE ONLY TO LEVEL 3 CALLERS:
[&]Run Remote Door: This will execute a remote door that you
have set up. You can run any DOS program
that can be run over the modem, such as
any utilities with no graphics (like
PKZIP) or remote editors such as EDLIN.
NOTE: You should not run online games
because QuickHost does not pass any
parameters to the door. Also, if you want
to run programs such as WordPerfect
remotely, use a program called DoorWay.
Check BBSs in your area to see if they
have this program. If not, contact me and
I will do my best to send you a copy. If
you do use DoorWay, PLEASE register it
with the author (Marshall Dudley) as you
will be supporting a fine shareware
program! (And don't forget to register
Telix as well!) :)
[#]View Log File: Allows the remote Sysop to view the log
file.
[!]DOS Shell: Allows the remote Sysop to shell to DOS.
You can set this batch file to run a
remote shell program if you have one.
Don't ask me where to find one, but I do
know one or two exist. Apparently, these
shell programs monitor the comm port and
reboot if the user drops carrier while in
DOS. This type of program also offers
extra security and safety features that
QuickHost does not offer. If you DO NOT
want remote DOS shelling, put the
following in your batch file:
CTTY COMx
ECHO Sorry, remote DOS shell is disabled!
CTTY CON
QuickHost will automatically come back. x
is your COM port...so if you are using
com port 1, then you would put COM1.
[@]Edit User List: Runs a remote editor (currently set up
for EDLIN) and allows you to edit the
user list.
[*]Turn Host Off: Turns QuickHost OFF. QuickHost will no
longer accept any calls. Use this command
CAREFULLY!
You may be wondering why the Sysop command options have been
assigned to "difficult" characters. Well, an unauthorized user
attempting to try out one of these commands can "accidently"
press the 'S' (was for the [S]hell command) key. Unless they are
extremely stupid, it is a physical impossibility to "accidently"
type 'SHIFT-1' (to get a '!'. This has been done to improve
security).
While the caller is online, the Sysop also as a choice of
functions from the keyboard. They are:
F1 - Terminate user <----- Hangs up
F2 - DOS functions <----- Brings up DOS functions
F3 - Chat with user <----- Enter chat mode
F4 - Edit user list <----- Edit user list
F5 - Chat ON <----- Turns chat ON
F6 - Chat OFF <----- Turns chat OFF
F7 - Sysop help menu <----- Displays help menu
ESC - Exit QuickHost <----- Returns you to Telix
ALT-1 - Access level 1 <----- Gives user access level 1
ALT-2 - Access level 2 <----- Gives user access level 2
ALT-3 - Access level 3 <----- Gives user access level 3
At the bottom of the screen, QuickHost displays a status bar. The
status bar contains the following information:
NAME OF CALLER|ACCESS LEVEL|CHAT ON/OFF|QUICKHOST v2.11
A sample status bar looks like this:
Christopher Saunders|3|Q| QuickHost v2.11
CHAT ON/OFF tells the user whether chat is on or off. If a 'C' is
displayed, then it means that the sysop is AVAILABLE FOR CHAT. A
'Q' (QUIET) means that the sysop is NOT AVAILABLE for chat.
When QuickHost is terminated (either locally or remotely) it
restores your original Telix status bar for you.
PROTOCOLS
---------
When the [D]ownload or [U]pload option is selected by a caller,
he is presented with the file PROTOCOL.MNU, showing the protocols
available.
Protocol selections:
[X]modem: Sends files in blocks of 128 characters at a
time. When the receiving computer is satisfied
that one block has arrived intact, it signals so
and waits for the next block. Error checking is a
Checksum or a more sophisticated Cyclic
Redundancy Check.
[1]k-Xmodem: This is a small variation of Xmodem that uses
blocks that are 1024 bytes in size.
[G]-1k-Xmodem: This is a variation of 1k-Xmodem that is meant
for error free channels such as error correcting
modems or null modem cable links between two
computers. It sends blocks one after another
without waiting for acknowledgment from the
receiver.
[Y]modem: This protocol is a variation of Xmodem which
keeps the correct name, size, and date of the
files being sent. It may use 128 or 1024 byte
blocks.
Ymod[E]m-G: This protocol is a variation of Ymodem, which
requires an error free channel such as error
correcting modems or null modem cables. It sends
one block after another without waiting for
acknowledgment from the receiver.
[S]ealink: This is an advanced version of Xmodem that is 15
to 25 percent faster than regular Xmodem. Sealink
passes a file's name, size, and date when
transferring.
[Z]modem: This advanced protocol is very fast and reliable
and offers many features. It keeps the exact file
sizes and dates, and can resume an interrupted
transfer at a later time. The latter is known as
Crash Recovery. It is recommended that Zmodem is
used for all data transmissions as it is the
fastest and most reliable protocol offered by
Telix.
For the moment, (until I can figure it out!), QuickHost does not
support external protocols...sorry!
BUGS
----
Like any other program, QuickHost has bugs. I have done my best
to ensure that the bugs that are present are not serious, but I
do not guarantee anything! To the best of my knowledge, all of
the bugs are just stupid, annoying little critters that will be
terminated (hasta La vista, baby!) in the near future. The bugs
are as follows:
FILE LISTINGS: I have tried to make it so that access
level 1 users cannot use this feature,
but for some stupid reason, I cannot
make that happen. Different methods I
tried royally screwed the whole program
up, so I had to leave it as it is. This
is *NOT* going to compromise the
security of your system. All new users
will be able to do is view the files
available, NOT (repeat, N-O-T)
download/upload/type them. If you do not
believe me, try it for yourself!
LACK OF ANSI GRAPHICS: This may be viewed by some as a bug, but
I view it as a feature that QuickHost
lacks. Lots of other host programs have
ANSI, but unfortunately, I am not that
good of a SALT programmer to create a
host mode with ANSI. Besides, it would
make the program a lot bigger, and
slower. I also found that ANSI screws up
your status bar in Telix. ASCII is not a
bad substitute, is very fast, and can be
viewed by (almost) any other computer.
MINOR QUIRK: I have thoroughly tested QuickHost to
make sure that it operates as safely and
efficiently as possible. However, there
is a MINOR quirk that you should be
aware of. You should not use any of the
function keys when a user is logging on
or entering a message because QuickHost
will "stick". So you can understand what
I mean, log on locally and press F7 or
F5/F6 when you are asked for your
password. If you pressed F7 (the help
menu), press ENTER to return to the log
on prompt. You will get a message saying
"incorrect password" because QuickHost
has intercepted your carriage return. If
you press F5 or F6, you will make the
cursor go to row 24, column 10. It is
alright to use the functions keys at the
main menu or the protocol menu. I am
working on this problem, and will
hopefully have it solved by the next
version. THIS MINOR QUIRK WILL IN NO WAY
COMPRIMISE THE SECURITY OF YOUR SYSTEM.
Those are all of the bugs that I could find. If you spot any that
I missed, then please leave me a message in the Telix support
echo (found on FidoNet) or write me a letter. Your bug report
will be mentioned in the manual of future releases.
TELIX v3.21
-----------
By now most of you know that Jeff Woods has purchased Telix from
Colin Sampaleanu and has started his own company, deltaComm
Development. He is working on Telix with Dan Horn, the author of
HostPlus (formerly Host3). For detailed information about Telix
v3.21, please read the documentation that comes with the
distribution files.
Telix v3.21 comes with a BBS like host called HostPlus. It is an
excellent host that was written by Dan Horn. It offers many
features that a full-sized BBS program offers but is a lot
smaller. If you are looking for advanced features like ANSI
graphics, multiple file and message areas, door support and other
BBS type features, I recommend you try out HostPlus. If you are
looking for a host without the extra fat and calories of
HostPlus, then use QuickHost!
SUPPORT SHAREWARE!
------------------
Telix is the finest communication program available today. Telix
v3.21 has the following features:
- Autodownload for external protocols
- 5 slots for external protocols
- SIMPLE language to make writing logon scripts easy for
non-programmers.
- Progress bar and percentage counter on all internal
protocols that tells you at a glance how the transfer is
doing.
- A powerful BBS/Host (written in SALT) that allows you to
set up your own host system. If you need something a little
smaller, easier to use and less complicated, then use
QuickHost.
- You can now tag files when uploading, so you do not have to
shell to DOS and do a "DIR/W" command in your UPLOADING
directory to get a filename. It comes in handy when you
want to upload a large number of files!
...and lots of other features I forgot to mention. See the
Telix v3.21 documentation for more information!
If you have not registered Telix yet, then why not do so now! You
will be getting a fantastic communication program at a bargain
price, supporting the future development of Telix, and will be
eligable to upgrade to the NEW, commercial version of Telix
when it comes out in 1993!
SPECIAL THANKS
--------------
Thanks go to the following people for their assistance:
MELISSA SAUNDERS: She is my sister, and did a lot for me
in my life, and deserves some credit!
COLIN SAMPALEANU: We all know who this person is! Without
Colin, there would be no Telix, so
there would be no QuickHost (the
horror!). My thanks go to Colin for
creating such a wonderful communication
program at a fantastic price!
JEFF WOODS: The new owner of Telix. See the section
on Telix v3.21 for more information.
My thanks go to Jeff for working hard
to develop Telix and continueing the
excellent technical support!
DAN HORN: Working with Jeff to make Telix a
better product. He is the author of the
SIMPLE language (see Telix v3.21
documentation) and HostPlus (formerly
Host3).
ROGER HAVARKY: The author of the now (unfortunately!)
defunct BuzzHost. I used BuzzHost as a
guide to create QuickHost v1.00, and
would like to extend my thanks to him
for creating the prototype. If you have
ever looked at BuzzHost, you will see
that QuickHost v2.11 is a great
improvement.
DENNIS SEATON: The author of DBBS which is another
defunct host program for Telix. DBBS
gave me ideas and inspiration for
QuickHost.
ZACK JONES: The moderator of the FidoNet Telix
Support BBS. He works very hard to keep
order in this echo and is a Telix beta
tester for deltaComm Development.
I can be contacted at the following address:
1562 Danforth Avenue
P.O. Box 72062
Toronto, Ontario
M4J 5C1
Canada
Thank you for using QuickHost!
Christopher Saunders
Author of QuickHost